home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / complib / dorgr2.z / dorgr2
Encoding:
Text File  |  1998-10-30  |  2.1 KB  |  67 lines
  1.  
  2.  
  3.  
  4. DDDDOOOORRRRGGGGRRRR2222((((3333FFFF))))                                                          DDDDOOOORRRRGGGGRRRR2222((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      DORGR2 - generate an m by n real matrix Q with orthonormal rows,
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      SUBROUTINE DORGR2( M, N, K, A, LDA, TAU, WORK, INFO )
  13.  
  14.          INTEGER        INFO, K, LDA, M, N
  15.  
  16.          DOUBLE         PRECISION A( LDA, * ), TAU( * ), WORK( * )
  17.  
  18. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  19.      DORGR2 generates an m by n real matrix Q with orthonormal rows, which is
  20.      defined as the last m rows of a product of k elementary reflectors of
  21.      order n
  22.  
  23.            Q  =  H(1) H(2) . . . H(k)
  24.  
  25.      as returned by DGERQF.
  26.  
  27.  
  28. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  29.      M       (input) INTEGER
  30.              The number of rows of the matrix Q. M >= 0.
  31.  
  32.      N       (input) INTEGER
  33.              The number of columns of the matrix Q. N >= M.
  34.  
  35.      K       (input) INTEGER
  36.              The number of elementary reflectors whose product defines the
  37.              matrix Q. M >= K >= 0.
  38.  
  39.      A       (input/output) DOUBLE PRECISION array, dimension (LDA,N)
  40.              On entry, the (m-k+i)-th row must contain the vector which
  41.              defines the elementary reflector H(i), for i = 1,2,...,k, as
  42.              returned by DGERQF in the last k rows of its array argument A.
  43.              On exit, the m by n matrix Q.
  44.  
  45.      LDA     (input) INTEGER
  46.              The first dimension of the array A. LDA >= max(1,M).
  47.  
  48.      TAU     (input) DOUBLE PRECISION array, dimension (K)
  49.              TAU(i) must contain the scalar factor of the elementary reflector
  50.              H(i), as returned by DGERQF.
  51.  
  52.      WORK    (workspace) DOUBLE PRECISION array, dimension (M)
  53.  
  54.      INFO    (output) INTEGER
  55.              = 0: successful exit
  56.              < 0: if INFO = -i, the i-th argument has an illegal value
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.